home *** CD-ROM | disk | FTP | other *** search
/ PC Media 7 / PC MEDIA CD07.iso / share / udos / gd350 / gd.doc < prev    next >
Encoding:
Text File  |  1994-04-26  |  6.4 KB  |  182 lines

  1.  
  2.  
  3.  
  4.        GD.COM     (Goto Directory)                          [v1.0: 17/4/90]
  5.        ======     ================
  6.  
  7.  
  8.  
  9.        This command makes it possible to quickly move to another directory.
  10.        It keeps a hidden file containing the directory structure in the
  11.        root directory of each drive it has been used on.
  12.  
  13.        This program is FreeWare: It might be distributed and used freely.
  14.        There exists no warranty, and the author shall not be liable for any
  15.        loss or damage due to using this program.
  16.  
  17.        Written in C using Borland's great compiler by
  18.  
  19.            Sverre H. Huseby
  20.            Bjoelsengt. 17
  21.            N-0468 Oslo
  22.            Norway
  23.  
  24.            Phone: +47 22 23 05 39
  25.  
  26.            Internet: sverrehu@ifi.uio.no
  27.  
  28.        If you like the program, please do me two small favours:
  29.          1. Send me a note (E-mail, postcard or letter) and tell me about
  30.             it. That's worth more than a few bucks!
  31.          2. Let your friends have a copy! (with all files intact, please..)
  32.  
  33.  
  34.  
  35.        Usage
  36.        -----
  37.  
  38.        GD accepts several options starting with a '-' or a '/'. Options
  39.        are case sensitive. The command line syntax is:
  40.  
  41.            GD [options] dirname
  42.  
  43.        Options can be zero or more of the following:
  44.  
  45.            -?  Display short help.
  46.  
  47.            -a  Enable auto-rebuild (see -r) when the current directory
  48.                isn't found in the structure-file. This is on by default.
  49.  
  50.            -h  Include directories with hidden/system attributes when
  51.                scanning the directory structure. This is off by default.
  52.  
  53.            -l  Display filenames using lowercase letters. This is off by
  54.                default.
  55.  
  56.            -r  Rebuild the directorystructure file. Use this when GD
  57.                complains about unknown directories, or to update the file
  58.                when directories have been added or removed.
  59.  
  60.        Options may be followed by a - to disable the default behaviour.
  61.  
  62.  
  63.  
  64.        How GD searches for a directory
  65.        -------------------------------
  66.  
  67.        GD works like a normal CD in the following cases:
  68.  
  69.            * If a backslash (\) is part of the name specified.
  70.            * If .. is given.
  71.            * If there is a directory with the name given in the current
  72.              directory.
  73.  
  74.        Else GD uses a hidden file (\DIRINFO.GD) containing the disk's tree-
  75.        structure to locate the given directory somewhere in the tree.
  76.        Suppose your C:-disk has the following tree-structure:
  77.  
  78.  
  79.                                    \ (root)
  80.                               .....   :    .....
  81.                            ...        :         ...
  82.                         ...           :            ...
  83.                     BIN            BORLANDC            HOME
  84.                                      ::                 :
  85.                                     :  :                :
  86.                                    :    :               :
  87.                                 BIN      INCLUDE      SVERRE
  88.                                                         :
  89.                                                         :
  90.                                                         :
  91.                                                        BIN
  92.  
  93.  
  94.        (Note that there are three BIN-directories at different levels.)
  95.        When searching for a directory, GD will start in the current, and
  96.        look for a match scanning down each level from left to right. When
  97.        the bottom is reached, the search continues from the top, until the
  98.        current directory. If, during the search, a match is found, the
  99.        search ends, and GD makes that directory the current.
  100.  
  101.        To save some typing, a match is defined to be a directory who's name
  102.        _starts_ with the name given. Let's look at a couple examples:
  103.  
  104.            C:\>gd bor
  105.            --> C:\BORLANDC
  106.            C:\BORLANDC>
  107.  
  108.        Here the current directory is the root. Searching from the top
  109.        gives a match in BORLANDC.
  110.  
  111.            C:\BORLANDC>gd bin
  112.            --> C:\BORLANDC\BIN
  113.            C:\BORLANDC\BIN>
  114.  
  115.        Starting in the directory \BORLANDC, searching right and down gives
  116.        \BORLANDC\BIN as the first match.
  117.  
  118.            C:\BORLANDC\BIN>gd bin
  119.            --> C:\HOME\SVERRE\BIN
  120.            C:\HOME\SVERRE\BIN>
  121.  
  122.        Now the `next' BIN-directory found was (not surprisingly) the one
  123.        to the right and down in the tree.
  124.  
  125.            C:\HOME\SVERRE\BIN>gd bin
  126.            --> C:\BIN
  127.            C:\BIN>
  128.  
  129.        This time searching to the right and down didn't give any match, so
  130.        GD started from the top, and found \BIN.
  131.  
  132.  
  133.  
  134.        Updating the directory structure
  135.        --------------------------------
  136.  
  137.        GD uses a hidden file (DIRINFO.GD) in the root-directory of each
  138.        drive to quickly scan the directory structure. This file needs to
  139.        be updated whenever directories are added or removed.
  140.  
  141.        If the current directory is not known (not in the file), GD will
  142.        (by default) rebuild the file on it's own. However if the directory
  143.        structure is changed without GD's knowing, you might have to direct
  144.        GD to rebuild using the option -r. This is the case if GD is unable
  145.        to find an existing directory, or if it tries to move to a location
  146.        that no longer exists.
  147.  
  148.        Note: Since GD will try to update the file if it sees an unknown
  149.        current directory, lots of rescanning will be the result if you
  150.        visit hidden directories without including them in the scan, or
  151.        disabling the auto-rebuild. (Puh! What a long sentence!)
  152.  
  153.  
  154.  
  155.        The environment variable GDCMD
  156.        ------------------------------
  157.  
  158.        Before the commandline options are interpreted, GD looks for an
  159.        environment variable named GDCMD. This might contain frequently used
  160.        options. If you for instance would always like hidden directories to
  161.        be included in a rebuild, enter the following line in your
  162.        AUTOEXEC.BAT:
  163.  
  164.            SET GDCMD=-h
  165.  
  166.        Any sequence of legal options may be given, and they can all be
  167.        overridden on the command line.
  168.  
  169.  
  170.  
  171.        Finally
  172.        -------
  173.  
  174.        If you decide to use this program, thanks! I would be happy hearing
  175.        from you if you find any bugs or spelllig errors, have any
  176.        suggestions, or just to know that one more person uses my program.
  177.  
  178.  
  179.  
  180.                                                    Sverre.
  181.  
  182.